<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>银行流水导入系统使用指南</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            margin: 20px;
            background-color: #f5f5f5;
            line-height: 1.6;
        }
        .container {
            max-width: 1000px;
            margin: 0 auto;
            background-color: white;
            padding: 30px;
            border-radius: 8px;
            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
        }
        h1, h2, h3 {
            color: #333;
        }
        h1 {
            text-align: center;
            border-bottom: 2px solid #007bff;
            padding-bottom: 10px;
        }
        h2 {
            border-left: 4px solid #007bff;
            padding-left: 10px;
            margin-top: 30px;
        }
        h3 {
            margin-top: 20px;
            color: #007bff;
        }
        .step {
            background-color: #f8f9fa;
            padding: 15px;
            border-radius: 4px;
            margin: 15px 0;
            border-left: 4px solid #28a745;
        }
        .note {
            background-color: #fff3cd;
            padding: 15px;
            border-radius: 4px;
            margin: 15px 0;
            border-left: 4px solid #ffc107;
        }
        .tip {
            background-color: #d1ecf1;
            padding: 15px;
            border-radius: 4px;
            margin: 15px 0;
            border-left: 4px solid #17a2b8;
        }
        ol, ul {
            padding-left: 20px;
        }
        li {
            margin-bottom: 10px;
        }
        img {
            max-width: 100%;
            height: auto;
            margin: 10px 0;
        }
        table {
            width: 100%;
            border-collapse: collapse;
            margin: 15px 0;
        }
        table, th, td {
            border: 1px solid #ddd;
        }
        th, td {
            padding: 12px;
            text-align: left;
        }
        th {
            background-color: #f8f9fa;
            font-weight: bold;
        }
        tr:nth-child(even) {
            background-color: #f8f9fa;
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>银行流水导入系统使用指南</h1>
        
        <h2>系统概述</h2>
        <p>银行流水导入系统是一个支持自定义字段映射的银行流水数据导入工具。该系统解决了不同银行流水格式不统一的问题，用户可以根据实际的银行流水文件格式自定义字段映射关系，实现灵活的数据导入。</p>
        
        <div class="note">
            <strong>注意：</strong>本系统支持Excel格式的银行流水文件导入，建议使用.xlsx格式文件。
        </div>
        
        <h2>使用流程</h2>
        
        <h3>第一步：创建银行流水导入配置</h3>
        <div class="step">
            <ol>
                <li>进入银行流水导入配置页面</li>
                <li>填写配置基本信息：
                    <ul>
                        <li><strong>配置名称</strong>：为配置命名，便于识别（如"中国银行流水导入配置"）</li>
                        <li><strong>银行类型</strong>：选择对应的银行类型</li>
                        <li><strong>文件类型</strong>：选择文件格式（目前支持Excel）</li>
                        <li><strong>备注</strong>：可填写配置说明信息</li>
                    </ul>
                </li>
                <li>点击"保存配置"按钮保存基本信息</li>
            </ol>
        </div>
        
        <h3>第二步：配置字段映射关系</h3>
        <div class="step">
            <ol>
                <li>上传银行流水文件：点击"选择银行流水文件"按钮，选择需要导入的银行流水Excel文件</li>
                <li>系统会自动解析文件并显示所有列信息</li>
                <li>为每一列配置对应的系统字段和字段类型：
                    <ul>
                        <li>系统会显示文件中的列索引和列名称</li>
                        <li>在"映射到系统字段"下拉框中选择对应的系统字段（包含"不映射"选项）</li>
                        <li>在"字段类型"下拉框中选择字段类型（普通字段、收入金额字段、支出金额字段、类型标识字段、付款人信息字段、收款人信息字段）</li>
                        <li>常见的系统字段包括：交易时间、交易金额、账户余额、交易类型、对方银行名称、对方卡号等</li>
                    </ul>
                </li>
                <li>点击"保存字段映射"按钮保存映射关系</li>
            </ol>
        </div>
        
        <div class="tip">
            <strong>提示：</strong>字段映射只需配置一次，后续导入同类型银行流水时可直接使用该配置。
        </div>
        
        <h3>第三步：导入银行流水</h3>
        <div class="step">
            <ol>
                <li>确保已正确配置字段映射关系</li>
                <li>选择需要导入的银行流水文件</li>
                <li>选择对应的资金账户</li>
                <li>点击"导入银行流水"按钮开始导入</li>
                <li>系统会根据配置的字段映射关系自动解析文件并导入数据</li>
            </ol>
        </div>
        
        <h2>处理不同银行流水格式</h2>
        
        <p>系统支持处理以下几种常见的银行流水格式：</p>
        
        <h3>情况一：收入/支出金额分离格式</h3>
        <div class="step">
            <p>某些银行的流水文件中，收入和支出金额分别在不同的列中显示：</p>
            <ul>
                <li><strong>收入金额列</strong>：显示收入金额，支出时为0或空</li>
                <li><strong>支出金额列</strong>：显示支出金额，收入时为0或空</li>
            </ul>
            <p><strong>配置方法：</strong></p>
            <ol>
                <li>将收入金额列映射到系统字段"收入金额(情况一)"，字段类型选择"收入金额字段"</li>
                <li>将支出金额列映射到系统字段"支出金额(情况一)"，字段类型选择"支出金额字段"</li>
                <li>系统会自动根据两列的值判断交易类型（收入或支出）</li>
            </ol>
        </div>
        
        <h3>情况二：借/贷标识格式</h3>
        <div class="step">
            <p>某些银行使用"借"和"贷"来标识交易类型：</p>
            <ul>
                <li><strong>"借"</strong>：表示支出</li>
                <li><strong>"贷"</strong>：表示收入</li>
            </ul>
            <p><strong>配置方法：</strong></p>
            <ol>
                <li>将交易金额列映射到系统字段"交易金额"</li>
                <li>将交易类型标识列映射到系统字段"类型标识(情况二/三)"，字段类型选择"类型标识字段"</li>
                <li>系统会自动根据标识列的值判断交易类型</li>
            </ol>
        </div>
        
        <h3>情况三：来账/往账标识格式</h3>
        <div class="step">
            <p>某些银行使用"来账"和"往账"来标识交易类型：</p>
            <ul>
                <li><strong>"来账"</strong>：表示收入</li>
                <li><strong>"往账"</strong>：表示支出</li>
            </ul>
            <p><strong>配置方法：</strong></p>
            <ol>
                <li>将交易金额列映射到系统字段"交易金额"</li>
                <li>将交易类型标识列映射到系统字段"类型标识(情况二/三)"，字段类型选择"类型标识字段"</li>
                <li>系统会自动根据标识列的值判断交易类型</li>
            </ol>
        </div>
        
        <h3>情况四：付款人/收款人信息动态映射</h3>
        <div class="step">
            <p>根据交易类型的不同，对方信息字段也会有所不同：</p>
            <ul>
                <li><strong>交易类型为收入(INCOME)</strong>：使用付款人信息（付款人开户行名、付款人账号、付款人名称）</li>
                <li><strong>交易类型为支出(EXPENSE)</strong>：使用收款人信息（收款人开户行名、收款人账号、收款人名称）</li>
            </ul>
            <p><strong>配置方法：</strong></p>
            <ol>
                <li>将付款人相关信息列映射到对应的系统字段（付款人开户行名、付款人账号、付款人名称），字段类型选择"付款人信息字段"</li>
                <li>将收款人相关信息列映射到对应的系统字段（收款人开户行名、收款人账号、收款人名称），字段类型选择"收款人信息字段"</li>
                <li>系统会根据交易类型自动选择使用付款人信息还是收款人信息来填充"对方银行名称"、"对方银行卡号"和"交易对手方"字段</li>
            </ol>
        </div>
        
        <h3>特殊情况：中国银行流水格式处理</h3>
        <div class="step">
            <p>中国银行的流水文件具有特殊格式，需要特别处理：</p>
            <ul>
                <li>文件包含表头行，实际数据从第9行开始（headerRowIndex=8）</li>
                <li>同时包含付款人和收款人信息，需要根据交易类型动态选择使用哪一方的信息</li>
                <li>付款人和收款人的相同字段（如银行名称、账号、名称）都映射到相同的系统字段，通过字段类型区分</li>
            </ul>
            <p><strong>配置方法：</strong></p>
            <ol>
                <li>上传中国银行流水文件后，系统会自动识别表头行索引</li>
                <li>将付款人相关信息列映射到对应的系统字段（对方银行名称、对方银行卡号、交易对手方），字段类型选择"付款人信息字段"</li>
                <li>将收款人相关信息列映射到对应的系统字段（对方银行名称、对方银行卡号、交易对手方），字段类型选择"收款人信息字段"</li>
                <li>将交易类型标识列映射到系统字段"类型标识(情况二/三)"，字段类型选择"类型标识字段"</li>
                <li>系统会根据交易类型自动选择使用付款人信息还是收款人信息</li>
                <li>系统会根据headerRowIndex确定数据起始行位置，正确解析数据</li>
            </ol>
        </div>
        
        <h2>系统字段说明</h2>
        <table>
            <thead>
                <tr>
                    <th>系统字段</th>
                    <th>说明</th>
                    <th>数据类型</th>
                    <th>示例</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td>交易时间 (tradingTime)</td>
                    <td>交易发生的具体时间</td>
                    <td>日期时间</td>
                    <td>2025-09-15 14:30:25</td>
                </tr>
                <tr>
                    <td>交易金额 (tradingAmount)</td>
                    <td>本次交易的金额</td>
                    <td>数值</td>
                    <td>1280.50</td>
                </tr>
                <tr>
                    <td>收入金额(情况一) (incomeAmount)</td>
                    <td>收入金额字段（情况一）</td>
                    <td>数值</td>
                    <td>1280.50</td>
                </tr>
                <tr>
                    <td>支出金额(情况一) (expenseAmount)</td>
                    <td>支出金额字段（情况一）</td>
                    <td>数值</td>
                    <td>0.00</td>
                </tr>
                <tr>
                    <td>类型标识(情况二/三) (typeIdentifier)</td>
                    <td>类型标识字段（情况二/三）</td>
                    <td>字符串</td>
                    <td>借/贷 或 来账/往账</td>
                </tr>
                <tr>
                    <td>账户余额 (balanceAmount)</td>
                    <td>交易后账户的余额</td>
                    <td>数值</td>
                    <td>5680.00</td>
                </tr>
                <tr>
                    <td>交易类型 (tradingType)</td>
                    <td>交易的类型</td>
                    <td>字符串</td>
                    <td>INCOME/EXPENSE</td>
                </tr>
                <tr>
                    <td>交易状态 (status)</td>
                    <td>交易的状态</td>
                    <td>字符串</td>
                    <td>SUCCESS/FAILED</td>
                </tr>
                <tr>
                    <td>支付渠道 (channel)</td>
                    <td>交易的支付渠道</td>
                    <td>字符串</td>
                    <td>WECHAT/ALIPAY/BANK</td>
                </tr>
                <tr>
                    <td>对方银行名称 (bankName)</td>
                    <td>交易对手方的银行名称</td>
                    <td>字符串</td>
                    <td>中国银行</td>
                </tr>
                <tr>
                    <td>对方银行卡号 (bankNo)</td>
                    <td>交易对手方的银行卡号</td>
                    <td>字符串</td>
                    <td>6222****1234</td>
                </tr>
                <tr>
                    <td>交易对手方 (counterparty)</td>
                    <td>交易的对方名称</td>
                    <td>字符串</td>
                    <td>张三</td>
                </tr>
                <tr>
                    <td>付款人开户行名 (payerBank)</td>
                    <td>付款人开户行名</td>
                    <td>字符串</td>
                    <td>中国银行</td>
                </tr>
                <tr>
                    <td>付款人账号 (payerAccount)</td>
                    <td>付款人账号</td>
                    <td>字符串</td>
                    <td>6222****1234</td>
                </tr>
                <tr>
                    <td>付款人名称 (payerName)</td>
                    <td>付款人名称</td>
                    <td>字符串</td>
                    <td>张三</td>
                </tr>
                <tr>
                    <td>收款人开户行名 (payeeBank)</td>
                    <td>收款人开户行名</td>
                    <td>字符串</td>
                    <td>工商银行</td>
                </tr>
                <tr>
                    <td>收款人账号 (payeeAccount)</td>
                    <td>收款人账号</td>
                    <td>字符串</td>
                    <td>6223****5678</td>
                </tr>
                <tr>
                    <td>收款人名称 (payeeName)</td>
                    <td>收款人名称</td>
                    <td>字符串</td>
                    <td>李四</td>
                </tr>
                <tr>
                    <td>交易描述 (tradingDescription)</td>
                    <td>对交易的描述信息</td>
                    <td>字符串</td>
                    <td>货款</td>
                </tr>
                <tr>
                    <td>备注 (remark)</td>
                    <td>交易的备注信息</td>
                    <td>字符串</td>
                    <td>无</td>
                </tr>
            </tbody>
        </table>
        
        <h2>常见问题</h2>
        
        <h3>1. 如何处理银行流水文件格式变更？</h3>
        <p>当银行流水文件格式发生变更时，您需要：</p>
        <ol>
            <li>进入对应的银行流水导入配置</li>
            <li>重新上传新的银行流水文件</li>
            <li>根据新文件的列结构调整字段映射关系</li>
            <li>保存新的字段映射配置</li>
        </ol>
        
        <h3>2. 导入时出现数据解析错误怎么办？</h3>
        <p>如果导入时出现数据解析错误，请检查：</p>
        <ul>
            <li>文件格式是否为Excel格式（.xlsx）</li>
            <li>字段映射配置是否正确</li>
            <li>日期格式是否符合要求（支持多种常见日期格式）</li>
            <li>数值字段是否包含非数字字符</li>
            <li>字段类型是否选择正确</li>
        </ul>
        
        <h3>3. 是否支持CSV格式文件？</h3>
        <p>目前系统主要支持Excel格式文件，后续版本将增加对CSV格式的支持。</p>
        
        <h2>最佳实践</h2>
        
        <div class="tip">
            <h3>建议1：为每家合作银行建立独立配置</h3>
            <p>建议为每家合作的银行建立独立的导入配置，这样可以避免混淆，并且当某家银行变更格式时不会影响其他银行的导入。</p>
        </div>
        
        <div class="tip">
            <h3>建议2：定期检查和更新配置</h3>
            <p>建议定期检查银行流水导入配置，确保字段映射关系与银行提供的最新格式保持一致。</p>
        </div>
        
        <div class="tip">
            <h3>建议3：保留导入文件备份</h3>
            <p>建议保留原始银行流水文件的备份，以便在需要时进行数据核对。</p>
        </div>
        
        <h2>技术支持</h2>
        <p>如有任何使用问题，请联系技术支持团队：</p>
        <ul>
            <li>电话：400-123-4567</li>
            <li>邮箱：support@vegetable-cloud.com</li>
            <li>在线客服：系统内联系客服</li>
        </ul>
    </div>
</body>
</html>